Getting Started#
TL;DR#
pip install waloviz
apt-get install ffmpeg
import waloviz as wv
wv.extension()
wv.Audio("https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav")
<class 'bokeh.models.plots.GridPlot'>
This web page was generated from a Jupyter notebook and not all interactivity will work on this website. Right click to download and run locally for full Python-backed interactivity.
Explanation#
waloviz was built to be as accessible as possible, whether you’re using jupyter, colab, VSCode, JupyterLab or just pure HTML - you’ll only need three lines of code.
First we need to install
waloviz:pip install waloviz
We also need to install
ffmpeg as a backend for torchaudio:apt-get install ffmpeg
Then we need to import
waloviz and activate the extension:import waloviz as wv
wv.extension()
import waloviz as wv
wv.extension("colab")
import waloviz as wv
wv.extension()
import waloviz as wv
wv.extension()
import waloviz as wv
# no need for the extension with pure HTML
Then we need to call
wv.Audio with our URL or file-path:wv.Audio('https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav')
wv.Audio('https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav')
wv.Audio('https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav')
wv.Audio('https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav')
wv.save('https://www2.cs.uic.edu/~i101/SoundFiles/CantinaBand3.wav') # saves to ``waloviz.html`` by default
And… that’s it, you’re done.
You can use the player to interact with your audio.
Using the player#
The controls are pretty intuitive, but here are the most important controls you should to know:
A single click on the spectrogram - toggles play\pause
Clicking on the bottom progress - moves the current time
Scrolling with the mouse wheel - zooms in\out
Dragging the mouse while pressing down - moves forwards\backwards
The small ↺ icon on the top left toolbar - resets to the initial view
Clicking on the
Download waloviz.html- downloads an HTML version of the player
To learn more, read our User Guide.